home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Topik / Topik - Disk 12 - Interesting and Helpful (19xx)(Topik Public Domain)(PD)[WB].zip / Topik - Disk 12 - Interesting and Helpful (19xx)(Topik Public Domain)(PD)[WB].adf / Larn / read.me < prev    next >
Text File  |  1989-07-14  |  13KB  |  265 lines
  1. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  2. * |_o_o|\\ Copyright (c) 1989 Jay Denebeim, The Software Distillery.        *
  3. * |. o.| ||        All Rights Reserved.                                     *
  4. * | .  | ||   Dave Baker         Edmund Burnette  Stan Chow    Jay Denebeim *
  5. * | o  | ||   Gordon Keener      John Mannering   Jack Rouse   John Toebes  *
  6. * |  . |//    Mary Ellen Toebes  Doug Walker                                *
  7. * ======           BBS:(919)-471-6436                                       *
  8. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  9.  
  10. ATTENTION:  AMIGA LARN is freely redistributable for non-commercial uses,
  11.             if this file accompanies it.  Please pass this file on with
  12.             any redistribution you do.  Any distribution without this file
  13.             is a COPYRIGHT VIOLATION.
  14.  
  15. Welcome to AMIGA LARN version 12.0C!
  16.  
  17. AMIGA LARN is brought to you through the efforts of The Software Distillery,
  18. a group committed to producing quality software for the Amiga at large.
  19.  
  20. Inquiries and flames should be directed via US Snail to:
  21.  
  22. Jay Denebeim
  23. 43 Fashion PL
  24. Durham, NC  27705
  25.  
  26. or
  27.  
  28. John A. Toebes, VIII
  29. The Software Distillery
  30. 235 Trillingham Lane
  31. Cary, North Carolina 27511
  32.  
  33. or on USENET
  34.  
  35. ...mcnc!rti-sel!sas!toebes
  36.  
  37. The latest version of Larn and our other projects are available for
  38. downloading from the Software Distillery bulletin board at (919)-471-6436.
  39. They can also be obtained from us directly at the above addresses.  Send US$6
  40. for a disk containing the latest Larn, or any of our other disks.  (Overseas
  41. include US$1 extra for postage).  Send a self-addressed, stamped envelope for
  42. a list of available disks.
  43.  
  44. Many Thanks to Shirley Galbrecht - Graphic Artist
  45.                SAS Institute Inc.
  46.                Box 8000 SAS Circle
  47.                Cary, North Carolina 27511
  48.   For her work on the graphics chacters.
  49.  
  50. ++++++++++++++++++++++++++++++++ ABOUT LARN +++++++++++++++++++++++++++++++++
  51.  
  52. This is a version of the public domain program LARN (copyright 1986 by
  53. Noah Morgan) implemented under AMIGADOS with the LATTICE C 5.01 compiler
  54. (from SAS Institute Inc.).
  55.  
  56. Larn is freely redistributable.  You may upload it to public bulletin
  57. boards, or give it to users groups, and individuals you feel would
  58. enjoy it.  Under no condition may you charge for Larn without explicit
  59. permission of the Software Distillery.
  60.  
  61. If you do enjoy the program and would like to support further
  62. development (and receive information on the latest updates) send a
  63. contribution to Edmund and his crew at the above address.  We welcome
  64. suggestions for improvements and upgrades.
  65.  
  66. +++++++++++++++++++++++++++++ INSTALLING LARN +++++++++++++++++++++++++++++++
  67.  
  68. Make a backup of this disk before doing anything.
  69.  
  70. ***** VERY IMPORTANT!!! *****
  71. Either the floppy containing this program must be named Larn, or the
  72. subdirectory containing this program must be assigned to Larn for the
  73. game to function!
  74.  
  75. You can use the Icon Editor 'HackIconII' to change any of the colors or
  76. characters used by the graphics version of Larn.  The characters for monsters
  77. and objects are kept in the files '.monsters' and '.objects' respectively.
  78. See the files 'HackIconII.doc', '.monsters.doc', and '.objects.doc' for more
  79. information.  HackIconII was written by Doug Walker.
  80.  
  81. There is also a configuration file '.larnopts' that you will want to edit
  82. to set your default options and player name.  See the online help in larn
  83. (the HELP key) for more information.
  84.  
  85. Additionally, this version of Larn supports environment variables with the
  86. same syntax as the .larnopts file entries.  NOTE:  to set the name variable
  87. use 'SetENV "name" "Foo Bar"' because 'name' is a keyword, it must have 
  88. quote marks around it.  Also, any parameter with spaces in it must have
  89. the same quote marks.
  90.  
  91. To install Larn on a hard disk, make a directory called DH0:LARN and copy
  92. the files from the disk into it.  Then enter the CLI command 
  93.  
  94.    assign Larn: dh0:Larn
  95.  
  96. You can then execute Larn normally.
  97.  
  98. +++++++++++++++++++++++++++++++ COMMON PROBLEMS ++++++++++++++++++++++++++++
  99.  
  100. Besides stack space, Larn uses a lot of dynamically allocated memory.
  101. If Larn keeps crashing unexpectedly, especially near the beginning of the
  102. game, chances are you are running out of memory.  Try running it with no
  103. background tasks and as few as possible open windows.  If you execute it
  104. from Workbench, close all CLI windows before executing Larn so it can
  105. shut down the Workbench while running.  Also, Version 1.2 of the ROM Kernel
  106. seems to take more memory that Version 1.1, so try 1.1 if you are having
  107. trouble with 1.2.
  108.  
  109. You should not have to use this method, but if all else fails...
  110. If you are still running out of memory, reboot your machine and hit control-D
  111. as soon as you see the first AmigaDos window appear.  
  112. Then type the Larn command:
  113.  
  114.    Larn
  115.  
  116. If you get a requester asking for you to insert the volume 'LARN' in any
  117. drive when you go to run your copied version of Larn, then you need to rename
  118. the copied disk to LARN using either the CLI relabel command or the rename
  119. option from workbench.  A common (VERY common) mistake is to delete the
  120. 'copy of' text from in front of the name leaving the space in front of LARN
  121. (Workbench likes to put 'copy of ' in front of any disk copied).  Make sure
  122. you delete the leading space also.
  123.  
  124. +++++++++++++++++++++++++++++++ PLAYING LARN ++++++++++++++++++++++++++++++++
  125.  
  126. If you've played Larn under UN*X or some other environment, you won't have
  127. any trouble with this version.  Many of the commands are the same.  Even if
  128. you haven't, however, you can use the menus in AMIGA LARN.  Just hold down
  129. the right menu button and select the command.  After you get to know the
  130. commands, you will be able to use the keyboard commands.  The keyboard
  131. command equivalent for each menu selection is listed next to the selection.
  132.  
  133. Three commands you will want to know are HELP, '/', and ALT-click.  Pressing
  134. the HELP or '?' key gets you into the online help system.  The '/' command
  135. displays all graphics characters used in the game.  Finally, to identify a
  136. particular graphics character on the screen, point the mouse at a character,
  137. hold the ALT key, and click on the monster or object you want identified.
  138.  
  139. Before you play, you might want to print out the file '.larn.help'. This is
  140. the file displayed with the HELP key.
  141.  
  142. You can use all the standard 'vi' style keys to move your player character
  143. around in Larn.  This is the way I prefer to play the game because it keeps
  144. my fingers in the same place I need them for entering commands and answering
  145. prompts.
  146.  
  147. For your convenience, however, you can also use the arrow and keypad keys.
  148. In addition, you can control your character three ways with the mouse.
  149. First, if you just click the mouse anywhere in the playing area, the
  150. character will try to move in that direction.  Second, you can click on your
  151. character and drag it wherever you want.  This is called 'mouse tracking'.
  152. Third, to make your character stay where it he is, just click on the
  153. character and release.  This is equivilent to the '.' command.  All this
  154. is explained in the online help.
  155.  
  156. NOTE:  For your safety, Larn will not allow you to move over known traps
  157. and pits with the mouse.  Also, if a monster takes a swipe at you while
  158. you are under mouse tracking, the tracking will be dropped.
  159.  
  160. In case you're interested, when you are moving the player character with the
  161. mouse, Larn tries to move into one of the three cells next to the current
  162. player position that are closest to the mouse.  It tries them in order of
  163. increasing distance.  If all three are blocked, it gives up and does not
  164. move the player (a cell is considered blocked if there is a wall or a
  165. visible trap there).  There is a special case if the player is right next
  166. to the mouse position but for some reason it can't move to that spot (for
  167. example, if the mouse was over a wall or pit).  If that happens, Larn gives
  168. up immediately.  Otherwise, it would probably thrash back and forth between
  169. adjacent squares and waste lots of time.  This is because when mouse tracking
  170. is on, Larn tries constantly to keep the player directly under the mouse.
  171. If the mouse for some reason gets ahead of the player, Larn will move the
  172. player multiple times to let him catch up.
  173.  
  174. +++++++++++++++++++++++++++++ 12.0C Changes +++++++++++++++++++++++++++++++++
  175.  
  176. Bug Fixes
  177.    Bugs?  What bugs?
  178. Additional Features
  179.    Environment variable support
  180.    Compiled under Lattice 5.0 giving a 30K reduction in code size!
  181.    Uses CBACK technology so the stack size no longer matters.
  182. Amiga Features
  183.    Nicer icons for starting the game from the Workbench (peel-away style
  184.    created using ZapIcon and SetAlternate).
  185.    Larn now closes the Workbench to free up extra memory. Close all
  186.    non-Workbench windows (like your CLI) to get the full effect.
  187.  
  188. +++++++++++++++++++++++++++++ WIZARD Mode ! ++++++++++++++++++++++++++++++++
  189.  
  190. Wizard mode under Larn allows you to play with almost complete
  191. invulnerability.  It is there to allow you to learn some of the finer points
  192. of Larn (and to help the me debug the program!).  To get into wizard mode,
  193. you must first make sure you are using the player name of "Wizard" in your
  194. .larnopts file, or environment variable:
  195.  
  196.    name: "Wizard"
  197.  
  198. This is not enough since you can play a perfectly normal game using this
  199. player name.  You must get into Larn and type the '_' command.  Larn will
  200. prompt for a password which happens to be 'amiga' (no quotes or carriage
  201. return). This mode gives you a +25 lance of death, a +50 ring of protection,
  202. 25 levels of experience, and one of everthing in the game.  It is useful for
  203. learning the game or for working off frustration (much better than kicking
  204. the stairs).  Once you are in, there is no way out of wizard mode!
  205.  
  206. One caveat: wizard mode will not allow you to save high scores (that would
  207. be cheating, wouldn't it?)
  208.  
  209. +++++++++++++++++++++ Help for the Beginning Programmer ++++++++++++++++++++
  210. If you are struggling with the Amiga and with learning how to program or 
  211. simply use your Amiga, there are two excellent sources of information:
  212.    Amazing Computing - generally available from your local Amiga dealer.
  213.      It is a 'slick' cover magazine with advertising and fairly high level
  214.      coverage of basic Amiga operations.  It has been extremely informative
  215.      and covers may advanced programming topics with farily indepth articles.
  216.         Available from your local dealer
  217.    The Amigan - PO Box 411, Hatteras NC 27511 - $24 for 6 issues/year
  218.      subtitled 'Apprentice and Journeyman', the Amigan is aimed at both the
  219.      beginning programmer and advanced hacker.  The editor, Dick Barnes has
  220.      a very readable style, making for easy and informative reading.  The
  221.      journal comes on 3 hole punched paper ready for building an ongoing
  222.      reference manual for the Amiga.  The articles tend to focus on solutions
  223.      to problems and approaches to take.  No advertising is taken so all
  224.      reviews are fair and hard-hitting.  Unlike other 'help' newsletters that
  225.      tend to be fly-by-night, the Amigan is informative and committed to
  226.      providing useful tips to make your life easier and more productive. A
  227.      must for the serious Amiga Programmer.
  228.  
  229. +++++++++++++++++++++ Other Public Domain Software ++++++++++++++++++++++++
  230.  
  231. Fred Fish
  232.  345 Scottsdale Rd
  233.  Pleasant Hill, CA 94523
  234.  
  235. Offers (now 150) disks of PD software for $6 each.  These are well organized
  236. and a MUST for any user group.
  237.  
  238.  
  239. ++++++++++++++++++++++ From the Software Distillery +++++++++++++++++++++++
  240. Other programs from the Software Distillery may be obtaining by calling our
  241. Bulletin board.  Many of these programs were used in the development of
  242. Larn.  At present we offer the following:
  243.  * C-Kermit (by Jack Rouse) - A telecommunications program that implements
  244.    the full Kermit protocol with many features such as remote commands and
  245.    batch file transfers.
  246.  * An advanced UN*X MAKE program with default rules and macro expansions.
  247.  * POPCLI - a screen saver program and 'hot-key' extension for bringing up
  248.    a new cli at the touch of a key.
  249.  * ICONEXEC - a program for making AmigaDOS programs run from workbench 
  250.    without any changes.
  251.  * SETALTERNATE a program for setting the alternate (selected) image on an 
  252.    icon to other than inverse.
  253.  * BLINK - an Amiga Linker that is FULLY ALINK compatible and up to 4 times
  254.    faster.  It supports many advanced linking features as well as an
  255.    excellent map facility.  A must for the serious programmer.
  256.  * TSIZE - a utility to list the amount of disk space taken up by tree
  257.    structured directories on a disk.  VERY useful when trying to clean up
  258.    on a disk (What *IS* taking so much space?!), especially for hard disks.
  259.  * WBRUN - A program for running workbench programs from CLI without having
  260.    to load workbench.
  261.  * MEMWATCH - A background utility to watch for ramdom memory trashing.
  262.  * HACK, another UN*X game ported to the Amiga by John Toebes.  A classic
  263.    every Amigan should have.
  264.  
  265.